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ABOUT THIS CHAPTER 


Warning: This chapter has not been updated to reflect changes and improvements 
that are available on systems using 32-Bit QuickDraw. For further 
information on 32-Bit QuickDraw, please refer to the 32-Bit QuickDraw 
documentation (available on "Phil & Dave's Excellent CD: The Release 
Version). 


Because the Macintosh II supports a variable sized screen, different screen 
depths, and even multiple screens, a new set of data structures and routines has 
been introduced to support, in a general way, the use of graphics devices 
(called gDevices). These data structures and routines are logically a part of 
Color QuickDraw, but because they are functionally quite independent of 
QuickDraw, they appear here in a separate chapter. 


A graphics device is used to 


associate a driver with a particular graphics output device 

define the size and color capabilities of the device 

define the position of a video screen with respect to other screens 
change the default matching routine used by the Color Manager 

keep track of the cursor for that device 

allocate a set of colors used by an offscreen bitMap 


eoeeeee 


Reader's guide: Graphics devices are generally used only by the system. You 
might need to use the information in this chapter, for example, 
if your application needs explicit knowledge of the pixel depth 
of the screen(s) it is drawing to, or if it wants to bring up a 
window on a particular screen. You might also use the 
information in this chapter if you want to allocate and 
maintain an offscreen bitMap. 


Before reading this chapter you should be familiar with the material in the 
chapter on Color QuickDraw. Some of the routine descriptions in this chapter 
also refer to the Color Manager, the Slot Manager, and the Device Manager 
chapters; you will only need to refer to those chapters if you are using those 
routines. 
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ABOUT GRAPHICS DEVICES 


When the system is started up, one handle to a gDevice record (described below) 
is allocated and initialized for each video card found by the system. These 
gDevice records are linked together in a linked list, which is called the 
DeviceList. 


By default, the gDevice record corresponding to the first video card found is 
marked as an active device (a device your program can use for drawing); all 
other devices in the list are marked as inactive. The ways that other devices 
become active are described below. When drawing is being performed on a device, 
that device is stored as theGDevice. 


If you want your application to write into an offscreen pixMap whose pixel depth 
or set of colors is different from that of the screen, your program must 
allocate a gDevice to describe the format of the offscreen pixMap. Your 
application could describe the set of colors that a printer can support, or 
represent an offscreen version of an image that spans multiple screens. More 
details of this technique are given below. 


GDevices that correspond to video devices have drivers associated with them. 
These drivers are used, for example, to change the mode of the device from 
monochrome to color, or to change the pixel depth of the device. GDevices that 
your application creates won't generally require drivers. The set of calls 
Supported by a video driver is defined and described in "Designing Cards and 
Drivers for Macintosh II and Macintosh SE." 
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DEVICE RECORDS 


ALL information that is needed to communicate with a graphics device is stored 
in a handle to a gDevice record, called a gdHandle. This information may 
describe many types of devices, including video displays, printers, or offscreen 
drawing environments. 


The structure of the gDevice record is as follows: 


TYPE 

GDHandle = *GDPtr; 

GDPtr = “GDevice; 

GDevice = RECORD 
gdRefNum: INTEGER; {reference number of driver} 
gdID: INTEGER; {client ID for search procedure} 
gdType: INTEGER; {device type} 
gdiTable: ITabHandle; {inverse table} 
gdResPref: INTEGER; {preferred resolution} 
gdSearchProc: SProcHndl; {list of search procedures} 
gdCompProc: CProcHndl; {list of complement procedures} 
gdFlags: INTEGER; {grafDevice flags word} 
gdPMap: PixMapHandle; {pixel map for displayed image} 
gdRefCon: LONGINT; {reference value} 
gdnextGD: GDHandle; {handle of next gDevice} 
gdRect: Rect; {device's global bounds} 
gdMode: LONGINT; {device's current mode} 
gdCCBytes: INTEGER; {rowBytes of expanded cursor data} 
gdCCDepth: INTEGER; {rowBytes of expanded cursor data} 
gdCCxData: Handle; {handle to cursor's expanded data} 
gdCCXMask: Handle; {handle to cursor's expanded mask} 
gdReserved: LONGINT {reserved for future expansion} 

END; 


Field descriptions 


gdRefNum The gdRefNum is a reference number of the driver for the 
display device associated with this card. For most display 
devices, this information is set at system startup time. 


gdID The gdID field contains an application-settable ID number 
identifying the current client of the port. It is also used 
for search and complement procedures (see "The Color Manager: 
Search and Complement Procedures"). 


gdType The gdType field specifies the general type of device. 
Values include: 


CLUT device (mapped colors with lookup table) 
fixed colors (no lookup table) 


0 
1 
2 direct RGB 
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These device types are described in the Color Manager chapter. 


gdITable The gdITable contains a handle to the inverse table for 
color mapping (see "The Color Manager: Inverse Tables"). 


gdResPref The gdResPref field contains the preferred resolution for 
inverse tables (see "The Color Manager: Inverse Tables"). 


gdSearchProc The gdSearchProc field is a pointer to the list of search 
procedures (see "The Color Manager: Search and Complement 
Procedures"); its value is NIL for a default procedure. 


gdCompProc The gdCompProc field is a pointer to a list of complement 
procedures (see "The Color Manager: Search and Complement 
Procedures"; its value is NIL for a default procedure. 


gdFlags The gdFlags field contains the gDevice's attributes. Do not 
set these flags directly; always use the procedures described 
in this chapter. 


gdPMap The gdPMap field is a handle to a pixel map giving 
the dimension of the image buffer, along with the 
characteristics of the device (resolution, storage format, 
color depth, color table). For gDevices, the high bit of 
theGDevice”**.gdPMap**. pmTable**.ctFlags is always set. 


gdRefCon The gdRefCon is a field used to pass device-related 
parameters (see SeedCFill and CalcCMask in the Color 
QuickDraw chapter). Since a device is shared, you shouldn't 
store data here. 


gdNextGD The gdNextGD field contains a handle to the next device in 
the deviceList. If this is the last device in the deviceList, 
this is set to zero. 


gdRect The gdRect field contains the boundary rectangle of the 
gDevice. The screen with the menu bar has topLeft = 0,0. 
All other devices are relative to it. 


gdMode The gdMode field specifies the current setting for the 
device mode. This is the value passed to the driver to 
set its pixel depth, etc. 


gdCCBytes The gdCCBytes field contains the rowBytes of the expanded 
cursor. Applications must not change this field. 


gdCCDepth The gdCCDepth field contains the depth of the expanded 
cursor. Applications must not change this field. 


gdCCXData The gdCCXData field contains a handle to the cursor's 
expanded data. Applications must not change this field. 


gdCCXMask The gdCCXMask field contains a handle to the cursor's 
expanded mask. Applications must not change this field. 
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gdReserved The gdReserved field is reserved for future expansion; 
it must be set to zero for future compatibility. 
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MULTIPLE SCREEN DEVICES 


This section describes how multiple screen devices are supported by the system. 
It tells how they are initialized, and once initialized, how they're used. 


When the system is started up, one of the display devices is selected as the 
startup screen, the screen on which the "happy Macintosh" icon appears. If a 
startup screen has been indicated in parameter RAM, then that screen is used. 
Otherwise, the screen whose video card is in the lowest numbered slot is used as 
the startup screen. By default, the menu bar is placed on the startup screen. 
The screen with the menu bar is called the main screen. 


The user can use the Control Panel to set the desired depth of each screen, 
whether it displays monochrome or color, and the position of that screen 
relative to the screen with the menu bar. Users can also select which screen 
should have the menu bar on it. See the Control Panel chapter for more 
information. All this information is stored in a resource of type 'scrn' (ID=0) 
in the system file. 


When the InitGraf routine is called to initialize QuickDraw, it checks the 
System file for this resource. If it is found, the screens are organized 
according to the contents of this resource. If it is not found, then only the 
startup screen is used. The precise format of a 'scrn' resource is described in 
the "Graphics Device Resources" section. 


When InitWindows is called, it scans through the device list and creates a 
region that is the union of all the active screen devices (minus the menu bar 
and the rounded corners on the outermost screens). It saves this region as the 
global variable GrayRgn, which describes and defines the desktop, the area on 
which windows can be dragged. Programs that paint the desktop should use 
FillRgn(GrayRgn,myPattern). Programs that move objects around on the desktop 
should pin to the GrayRgn, not to screenBits.bounds. 


Since the Window Manager allows windows to be dragged anywhere within the 
GrayRgn, windows can span screen boundaries, or be moved to entirely different 
screens. Despite this fact, QuickDraw can draw to the window's port as if it 
were all on one screen. In general terms, it works like this: when an 
application opens a window, the window's port.portBits.baseAddr field is set to 
be equal to the base address of the main screen. When QuickDraw draws into a 
grafPort or cGrafPort, it compares the base address of the port to that of the 
main screen. If they are equal, then QuickDraw might need to draw to multiple 
screens. 


If there are multiple screens, QuickDraw calculates the rectangle, in global 
coordinates, into which the drawing operation will write. For each active 
screen device in the device list, QuickDraw intersects the destination rectangle 
with the device's rectangle (gdRect). If they intersect, the drawing command is 
issued to that device, with a new pixel value for the foreground and background 
colors if necessary. In addition, patterns and other structures may be 
reexpanded for each device. 
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GRAPHICS DEVICE ROUTINES 


The following set of routines allows an application to create and examine 
gDevice records. Since most device and driver information is automatically set 
at system startup time, these routines are not needed by most applications that 
Simply draw to the screen. 


FUNCTION NewGDevice(refNum: INTEGER; mode: LONGINT) GDHandle; 


The NewGDevice function allocates a new gDevice data structure and all of its 
handles, then calls InitGDevice to initialize it for the specified device in the 
specified mode. If the request is unsuccessful, a NIL handle is returned. The 
new gDevice and all of its handles are allocated in the system heap. All 
attributes in the GDFlags word are set to FALSE. 


If your application creates a gDevice without a driver, the mode parameter 
should be set to -1. In this case, InitGDevice is not called to initialize the 
gDevice. Your application must perform all initialization. 


A graphics device's default mode is defined as 128, as described in the 
Designing Cards and Drivers manual; this is assumed to be a monochrome mode. If 
the mode parameter is not the default mode, the gdDevType attribute is set TRUE, 
to indicate that the device is capable of displaying color (see the 
SetDeviceAttribute call). 


This routine doesn't automatically insert the gDevice into the device list. In 
general, your application shouldn't add devices that it created to the device 
list. 


PROCEDURE InitGDevice(gdRefNum: INTEGER; mode: LONGINT; gdh: GDHandle) ; 


The InitGDevice routine sets the video device whose driver has the specified 
gdRefNum to the specified mode. It then fills out the gDevice record structure 
specified by the gdh parameter to contain all information describing that mode. 
The GDHandle should have been allocated by a call to NewGDevice. 


The mode determines the configuration of the device; possible modes for a 
device can be determined by interrogating the video card's ROM via calls to the 
Slot Manager (refer to the Slot Manager chapter and the Designing Cards and 
Drivers manual). Refer to the Device Manager chapter for more details about the 
interaction of devices and their drivers. 


The information describing the new mode is primarily contained in the video 
card's ROM. If the device has a fixed color table, then that table is read 
directly from the ROM. If the device has a variable color table, then the 
default color table for that depth is used (the 'clut' resource with ID=depth). 


In general, your application should never need to call this routine. All video 
devices are initialized at start time and their modes are changed by the control 
panel. If your program is initializing a device without a driver, this call 

will do nothing; your application must initialize all fields of the gDevice. It 
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is worth noting that after your program initializes the color table for the 
device, it needs to call MakeITable to build the inverse table for the device. 


FUNCTION GetGDevice: GDHandle; 

The GetGDevice routine returns a handle to the current gDevice. This is useful 
for determining the characteristics of the current output device (for instance 
its pixelSize or color table). Note that since a window can span screen 
boundaries, this call does not return the device that describes a port. 


Assembly-language note: A handle to the currently active device is kept 
in the global variable TheGDevice. 


PROCEDURE SetGDevice(gdh: GDHandle) ; 

The SetGDevice procedure sets the specified gDevice as the current device. Your 
application won't generally need to use this call except to draw to offscreen 
gDevices. 

FUNCTION DisposGDevice: GDHandle; 


The DisposGDevice function disposes of the current gDevice and releases the 
space allocated for it, and all data structures allocated by NewGDevice. 


FUNCTION GetDeviceList: GDHandle; 


The GetDeviceList function returns a handle to the first device in the 
DeviceList. 


Assembly-language note: A handle to the first element in the device 
list is kept in the global variable DeviceList. 


FUNCTION GetMainDevice: GDHandle; 

The GetMainDevice function returns the handle of the gDevice that has the menu 
bar on it. Your application can examine this gDevice to determine the size or 
depth of the main screen. 


Assembly-language note: A handle to the current main device is kept 
in the global variable MainDevice. 


FUNCTION GetNextDevice (gdh: GDHandle): GDHandle; 


The GetnextDevice function returns the handle of the next gDevice in the 
DeviceList. If there are no more devices in the list, it returns NIL. 


PROCEDURE SetDeviceAttribute: (gdh: GDHandle; attribute: INTEGER; 
value: BOOLEAN) ; 


The SetDeviceAttribute routine can be used to set a device's attribute bits. The 
following attributes may be set using this call: 


gdDevType = 0; {0 = monochrome, 1 = color} 
ramInit = 10; {set if device has been initialized from RAM} 
mainScreen = 11; {set if device is main screen} 
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allInit 12; {set if devices were initialized from a 'scrn' resource} 


screenDevice = 13; {set if device is a screen device} 
noDriver = 14; {set if device has no driver} 
screenActive = 15; {set if device is active} 


FUNCTION TestDeviceAttribute (curDevice: GDHandle; 
attribute: INTEGER) : BOOLEAN; 


The TestDeviceAttribute function tests a single attribute to see if it is true 
or not. If your application is scanning through the device list, it would 
typically use this routine to test if a device is a screen device, and if so, 
test to see if it's active. Then your application can draw to any active screen 
devices. 


FUNCTION GetMaxDevice (globalRect: Rect) :GDHandle; 
The GetMaxDevice routine returns a handle to the deepest device that intersects 


the specified global rectangle. Your application might use this routine to 
allocate offscreen pixMaps, as described in the following section. 
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DRAWING TO OFFSCREEN DEVICES 


It's sometimes desirable to perform drawing operations offscreen, and then use 
CopyBits to transfer the complete image to the screen. One reason to do this is 
to avoid the flicker that can happen when your program is drawing overlapping 
objects. Another reason might be to control the set of colors used in the 
drawing (for instance, if your application performs imaging for a printer that 
has a different set of colors than the screen). For both these examples, your 
application needs control of the color environment, and thus needs to make use 
of gDevices. 


First, let's look at the example of drawing a number of objects offscreen, and 
then transferring the completed image to the screen. In this case, the 
complicating factor is the possibility that your program may open a window that 
will span two (or more) screens with different depths. One way to approach the 
problem is to allocate the offscreen pixMap with a depth that is the same as the 
deepest screen touched by the window. This allows your program to perform 
offscreen drawing with the maximum number of colors that is used by any window, 
giving optimal visual results. Another approach is to allocate the offscreen 
pixMap with the depth of the screen that contains the largest portion of the 
window, so that transfers to the screen will be as fast as possible. You might 
want to alternate between these techniques depending on the position of the 
window. 


Optimizing Visual Results 


When allocating a pixMap for the deepest screen, your application should first 
allocate an offscreen grafPort that has the depth of the deepest screen the 
window overlaps. To do this, your application must save the current gDevice 
(GetGDevice), get the deepest screen (GetMaxDevice), set that to be the current 
gDevice (SetGDevice), create a new cGrafPort (OpenCPort), and then restore the 
saved gDevice (SetGDevice again). Since OpenCPort initializes its pixMap using 
TheGDevice, the current grafPort is the same as the deepest screen. 


Next, your application must allocate storage for the pixels by setting 
portPixMap**.bounds to define the height and width of the desired image, and 
setting rowBytes to ((width*portPixMap**.pixelSize)+15)DIV 16*2. (Note that 
rowBytes must be even, and for optimal performance should be a multiple of 
four. Your application can adjust portPixMap**.bounds to achieve this.) 
Next, define the interior of portPixMap.bounds to which your application can 
write by setting portRect. Now that the size of the pixMap is defined, the 
amount of storage is simply the height*portPixMap**.rowBytes. It is generally 
better to allocate the storage as a handle. Before writing to it, your 
application should lock the handle, and place a pointer to the storage in 
portPixMap**.baseAddr. 


ALL that remains is to draw to the grafPort. Before drawing, your program 
should save the current gDevice, and then set TheGDevice to be the maximum 
device (which was determined earlier). Your application can use SetPort to make 
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this port the current port, and then perform all drawing operations. Remember 
to have your application restore TheGDevice after drawing is complete. 


Keep in mind that all this preparation can be invalidated easily. If the user 
changes the depth of the screen or moves the window, all your carefully 
allocated storage may no longer be appropriate. Both changing the depth of the 
screen and moving the window across device boundaries will cause update events. 
In your application's update routine, include a test to see if the environment 
has changed. One good test is to determine whether the color table has changed. 
Your application can compare the ctSeed field of the new maximum device with 
that of the old maximum device. (See the Color Manager chapter for more 
information on this technique.) If ctSeed has changed, your application should 
check the screen depth, and if it has changed, reallocate the pixMap (possibly 
repeating the entire process above). If the depth hasn't changed, but the color 
table has, then your application can just redraw the objects into the offscreen 
pixMap. 


Optimizing Speed 


If you decide to optimize for speed instead of appearance, then your application 
should examine each element in the device list to see how much of the window it 
intersects. Your application can do this by getting the device list 
(GetDeviceList), intersecting that device's rectangle with your window's 
rectangle, and then repeating the examination for each device by calling 
GetNextDevice. Before examining a device, your application can ensure that it 
is an active screen device using GetDeviceAttribute. The procedure for 
allocating the cGrafPort is the same as described above. 


Imaging for a Color Printer 


Finally, let's look briefly at the example of imaging into an offscreen device 
that isn't the same as one of the screen devices, which you might do if you were 
imaging for a color printer. In this case the process is much the same, but 
instead of relying on an existing gDevice to define the drawing environment, 
your application must set up a new one. To do this, simply call NewGDevice to 
allocate a new gDevice data structure. Your application must initialize all 
fields of the pixMap and color table, as described in the Color QuickDraw 
chapter. It should call then MakeITable to build the device's inverse table, as 
described in the Color Manager chapter. As with the example above, your 
application should set its gDevice as the current device before drawing to the 
offscreen pixMap. This will guarantee that drawing is done using the set of 
colors defined by your application's gDevice. 
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GRAPHICS DEVICE RESOURCES 


A new resource type has been added to describe the setup of graphics devices: 
"scrn' Screen resource type 


The 'scrn' resource contains all the screen configuration information for a 
multiple screen system. Only the 'scrn' resource with ID = 0 is used by the 
system. Normally your application won't have to alter or examine this resource. 
It's created by the control panel, and is used by InitGraf. 


The 'scrn' resource consists of a sequence of records, each describing one 
screen device. In the following description this sequence of records is 
represented by a Pascal FOR loop that repeats once for each screen device. 


‘scrn' (Screen configuration) 

ScrnCount [word] number of devices in resource 

FOR i := 1 to ScrnCount DO 
spDrvrHw [word] Slot Manager hardware ID 
slot [word] slot number 
dCtlDevBase [long] dCtlDevBase from DCE 
mode [word] Slot Manager ID for screen's mode 
flagMask [word] = $77FE 
flags [word] indicates device state 

bit 0 0 if monochrome; 1 if color 


bit 11 = 1 if device is main screen 
bit 15 = 1 if device is active 


colorTable [word] resource id of desired ‘clut' 
gammaTable [word] resource id of desired 'gama' 
global Rect [rect] device's global rectangle 
ctlCount [word] number of control calls 
FOR j := 1 to ctlCount DO 
csCode [word] control code for this call 
length [word] number of bytes in param block 
param blk [length] data to be passed in control call 
END; 
END; 


The records in the 'scrn' resource must be in the same order as cards in the 
slots (starting with the lowest slot). InitGraf scans through the video cards 
in the slots, and compares them with the descriptors in the 'scrn' resource. If 
the spDrvrHw, slot, and dCtlDevBase fields all match for every screen device in 
the system, the 'scrn' resource is used to initialize the video devices. 
Otherwise the 'scrn' resource is simply ignored. Thus if you move a video card, 
or add or remove one, the 'scrn' resource will become invalid. 


SpDrvrHw is a Slot Manager field that identifies the type of hardware on the 
card. (The spDrvrSw field on the card must identify it as an Apple-compatible 
video driver.) Slot is the number of the slot containing the card. DCtlDevBase 
is the beginning of the device's address space, taken from the device's DCE. 
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If all video devices match, the rest of the information in the 'scrn' resource 
is used to configure the video devices. The mode is actually the slot manager 
ID designating the descriptor for that mode. This same mode number is passed to 
the video driver to tell it which mode to use. 


The flags bits are used to determine whether the device is active (that is, 
whether it will be used), whether it's color or monochrome, and whether it's the 
main screen (the one with the menu bar). The flagMask simply tells which bits 
in the flags word are used. 


To use the default color table for a device, set the colorTable field to —1. To 
use the default gamma table for a device, set the gammaTable field to -1. 

(Gamma correction is a technique used to select the appropriate intensities of 
the colors sent to a display device. The default gamma table is designed for the 
Macintosh II 13-inch color monitor; other manufacturers’ color monitors might 
incorporate their own gamma tables. ) 


The global rect specifies the coordinates of the device relative to other 
devices. The main device must have topLeft = 0,0. The coordinates of all other 
devices are specified relative to this device. Devices may not overlap, and 
must share at least part of an edge with another device. To support future 
device capabilities, a series of control calls may be specified. These are 
issued to the driver in the given order. 
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SUMMARY OF GRAPHICS DEVICES 


Constants 


{ Values for GDFlags } 


clutType = 0; {0 if lookup table} 
fixedType = 15; {1 if fixed table} 
directType = 2; {2 if direct values} 


{ Bit assignments for GDFlags } 


gdDevType = 0; {0 = monochrome, 1 = color} 
ramInit = 10; {set if device has been initialized from RAM} 
mainScreen = 11; {set if device is main screen} 
allInit = 12; {set if devices were initialized from a 'scrn' resource} 
screenDevice = 13; {set if device is a screen device} 
noDriver = 14; {set if device has no driver} 
screenActive = 15; {set if device is active} 
Data Types 
TYPE 
GDHandle = *GDPtr; 
GDPtr = “GDevice; 
GDevice = RECORD 
gdRefNum: INTEGER; {reference number of driver} 
gdID: INTEGER; {client ID for search procedure} 
gdType: INTEGER; {device type} 
gdITable: ITabHandle; {inverse table} 
gdResPref: INTEGER; {preferred resolution} 
gdSearchProc: SProcHndl; {list of search procedures} 
gdCompProc: CProcHndl; {list of complement procedures} 
gdFlags: INTEGER; {grafDevice flags word} 
gdPMap: PixMapHandle; {pixel map for displayed image} 
gdRefCon: LONGINT; {reference value} 
gdnextGD: GDHandle; {handle of next gDevice} 
gdRect: Rect; {device's global bounds} 
gdMode: LONGINT; {device's current mode} 
gdCCBytes: INTEGER; {rowBytes of expanded cursor data} 
gdCCDepth: INTEGER; {rowBytes of expanded cursor data} 
gdCCxData: Handle; {handle to cursor's expanded data} 
gdCCXMask: Handle; {handle to cursor's expanded mask} 
gdReserved: LONGINT {reserved for future expansion} 
END; 
Routines 
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FUNCTION NewGDevice 
PROCEDURE InitGDevice 
FUNCTION GetGDevice: 
PROCEDURE SetGDevice 
PROCEDURE DisposGDevice 
FUNCTION GetDeviceList: 
FUNCTION GetMainDevice: 
FUNCTION GetNextDevice 


PROCEDURE SetDeviceAttribute 


FUNCTION TestDeviceAttribute 


FUNCTION GetMaxDevice 


(refNum: INTEGER; mode: LONGINT) : GDHandle; 
(gdRefNum: INTEGER; mode: LONGINT; gdh: GDHandle) ; 
GDHandle; 
(gdh: GDHandle) ; 
(gdh: GDHandle) ; 
GDHandle; 
GDHandle; 
(curDevice:GDHandle): GDHandle; 
(gdh: GDHandle; attribute: INTEGER; 
value: BOOLEAN) ; 
(gdh: GDHandle; attribute: INTEGER): BOOLEAN; 
(globalRect:Rect): GDHandle; 


Global Variables 


DeviceList {handle to the first element in the device list} 
GrayRgn {contains size and shape of current desktop} 
TheGDevice {handle to current active device} 

MainDevice {handle to the current main device} 


Assembly Language Information 


Values for GDTypes 


clutType EQU 0 ;0 if lookup table 
fixedType EQU 1 ;1 if fixed table 
directType EQU 2 ;2 if direct values 


Bit Assignments for GDFlags 


gdDevType EQU 0 

ramInit EQU 10 
mainScreen EQU 11 
alliInit EQU 12 
screenDevice EQU 13 
noDriver EQU 14 
screenActive EQU 15 


GDevice field offsets 


gdRefNum EQU $0 
gdID EQU $2 
gdType EQU $4 
gdITable EQU $6 
gdResPref EQU $A 


gdSearchProc EQU $C 
gdCompProc EQU $10 


gdFlags EQU $14 
gdPMap EQU $16 
gdRefCon EQU $1A 


50 


= monochrome, 1 = color 


sset if device has been initialized from RAM 
sset if device is main screen 
‘set if devices were initialized froma 


| 


"scrn' resource 


‘set if device is a screen device 
sset if device has no driver 
‘set if device is active 


s[word] unitNum of driver 

; [word] client ID for search procs 

;[word] fixed/CLUT/direct 

;[long] handle to inverse table 

; [word] preferred resolution for inverse tables 
;[long] search proc (list?) pointer 

;[ long] complement proc (list?) pointer 

; [word] grafDevice flags word 

;[long] handle to pixMap describing device 
;[long] reference value 
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gdNextGD EQU $1E ;handle of next gDevice 


gdRect EQU $22 ;device's global bounds 

gdMode EQU $2A ;device's current mode 

gdCCBytes EQU $2E ;rowBytes of expanded cursor data 
gdCCDepth EQU $30 ;handle to cursor's expanded data 
gdCCxData EQU $32 ;depth of expanded cursor data 
gdCCXMask EQU $36 ;handle to cursor's expanded mask 
gdReserved EQU $3A ;[ long] MUST BE 0 

gdRec EQU $3E ;size of GrafDevice record 


Global Variables 


DeviceList EQU $8A8 ‘handle to the first element in the device list 
GrayRgn EQU $9EE ;contains size and shape of current desktop 
TheGDevice EQU $CC8 shandle to current active device 

MainDevice EQU $8A4 ‘handle to the current main device 
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Further Reference: 


Color QuickDraw 

Color Manager 

Slot Manager 

Device Manager 

32-Bit QuickDraw Documentation 


END OF DOCUMENT 
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